Skip to content

docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8165

Closed
JSONbored wants to merge 1 commit into
mainfrom
docs/discovery-plane-operator-guide-finalize
Closed

docs(discovery-plane): finalize operator guide now that the plane is shipped and live#8165
JSONbored wants to merge 1 commit into
mainfrom
docs/discovery-plane-operator-guide-finalize

Conversation

@JSONbored

Copy link
Copy Markdown
Owner

Summary

Closes #7169.

Test plan

  • Docs-only change; no src/** changes, so no Codecov impact.
  • npx prettier --check passes on both changed files.
  • Verified live: curl https://discovery.loopover.ai/health → 200, /ready{"ready":true}.
  • Cross-checked every invariant claim against the actual shipped module (discovery-index-client.ts, discovery-index-contract.ts) rather than carrying over the original design doc unchanged.

…shipped and live

#7164/#7166/#7167 all closed and the discovery-index server is now deployed
at discovery.loopover.ai (Cloudflare Container + Worker). Rewrites the
operator guide (packages/loopover-miner + the mirrored docs-site mdx) from
"provisional/TBD" to the real, shipped opt-in mechanism:

- Documents the real env vars, including LOOPOVER_MINER_DISCOVERY_SHARED_SECRET
  (used for bearer auth against the hosted index), which wasn't in the
  original TBD list at all.
- Adds the maintainer-run instance's real URL and a verification step
  (dry-run discover) to the opt-in checklist.
- Corrects a real invariant-list drift found while verifying: the doc
  claimed telemetry uses HMAC-hashed repo/issue correlation identifiers,
  but the shipped recordDiscoveryTelemetry only ever emits a bare
  {event, outcome} local log line -- no hosted telemetry collector exists
  yet, so there's nothing to hash today.
- Marks server-side soft-claim dedup shipped (was "server-side dedup is
  #4250 [open]").

Closes #7169.
@superagent-security

Copy link
Copy Markdown
Contributor

Superagent didn't find any vulnerabilities or security issues in this PR.

@JSONbored JSONbored self-assigned this Jul 23, 2026
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
loopover-ui 1d8e8b1 Commit Preview URL

Branch Preview URL
Jul 23 2026, 07:37 AM

@JSONbored JSONbored closed this Jul 23, 2026
@codecov

codecov Bot commented Jul 23, 2026

Copy link
Copy Markdown

Bundle Report

Changes will decrease total bundle size by 577 bytes (-0.01%) ⬇️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
loopover-ui 7.45MB -577 bytes (-0.01%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: loopover-ui

Assets Changed:

Asset Name Size Change Total Size Change (%)
assets/add-scalar-classes-Ce6pLpEq.js (New) 2.17MB 2.17MB 100.0% 🚀
assets/tanstack-vendor-CSPtaVkW.js (New) 812.5kB 812.5kB 100.0% 🚀
openapi.json -496 bytes 525.57kB -0.09%
assets/docs.fumadocs-spike-api-reference-BBeTbKXc.js (New) 442.92kB 442.92kB 100.0% 🚀
assets/AgentScalarChatInterface.vue-DvIi_6V4.js (New) 201.71kB 201.71kB 100.0% 🚀
assets/modal-Oo_NP3QZ.js (New) 184.38kB 184.38kB 100.0% 🚀
assets/client-BPKvpd8S.js (New) 146.06kB 146.06kB 100.0% 🚀
assets/maintainer-panel-CFrsaE9_.js (New) 78.96kB 78.96kB 100.0% 🚀
assets/tuning-BEpwprKw.js (New) 64.47kB 64.47kB 100.0% 🚀
assets/ui-vendor-Ca8dfIdM.js (New) 57.04kB 57.04kB 100.0% 🚀
assets/routes-D-f4977V.js (New) 34.83kB 34.83kB 100.0% 🚀
assets/owner-panel-GUrbexb2.js (New) 27.33kB 27.33kB 100.0% 🚀
assets/app-DY_9b_ET.js (New) 25.7kB 25.7kB 100.0% 🚀
assets/ams-discovery-plane-BtWJ9Dmo.js (New) 25.16kB 25.16kB 100.0% 🚀
assets/app.runs-DC-7WezC.js (New) 23.56kB 23.56kB 100.0% 🚀
assets/miner-panel-rofRAmd-.js (New) 20.25kB 20.25kB 100.0% 🚀
assets/api._op-D8qDdxD8.js (New) 17.55kB 17.55kB 100.0% 🚀
assets/self-hosting-docs-audit-HIRAJL4Q.js (New) 16.63kB 16.63kB 100.0% 🚀
assets/app.index-DWbUHPoc.js (New) 15.62kB 15.62kB 100.0% 🚀
assets/playground-panel-B65EAHfn.js (New) 14.49kB 14.49kB 100.0% 🚀
assets/backtest-calibration-pfIEDXy_.js (New) 14.31kB 14.31kB 100.0% 🚀
assets/app.audit-DbPlCnpQ.js (New) 10.11kB 10.11kB 100.0% 🚀
assets/app.config-generator-CFlc9U1C.js (New) 10.09kB 10.09kB 100.0% 🚀
assets/extension-CaRXXLnM.js (New) 10.04kB 10.04kB 100.0% 🚀
assets/fairness-BvuL-E9l.js (New) 8.34kB 8.34kB 100.0% 🚀
assets/maintainers-LMJuoy6C.js (New) 8.03kB 8.03kB 100.0% 🚀
assets/miners-BK0iF5l2.js (New) 7.85kB 7.85kB 100.0% 🚀
assets/agents-BLZk3IkM.js (New) 7.76kB 7.76kB 100.0% 🚀
assets/commands-panel-Dwk-KADp.js (New) 6.65kB 6.65kB 100.0% 🚀
assets/maintainer-workflow-CqogwY96.js (New) 6.5kB 6.5kB 100.0% 🚀
assets/roadmap-DnnHw7eW.js (New) 6.33kB 6.33kB 100.0% 🚀
assets/digest-panel-IENLoWZO.js (New) 6.18kB 6.18kB 100.0% 🚀
assets/repos._owner._repo.quality-DkGmda79.js (New) 6.14kB 6.14kB 100.0% 🚀
assets/docs.index-QufjqMvV.js (New) 5.61kB 5.61kB 100.0% 🚀
assets/api.index-D7vvsKFr.js (New) 4.7kB 4.7kB 100.0% 🚀
assets/api-CqbQtKat.js (New) 2.69kB 2.69kB 100.0% 🚀
assets/docs-aRoaZhjN.js (New) 2.67kB 2.67kB 100.0% 🚀
assets/app.workbench-t89H3FUt.js (New) 1.58kB 1.58kB 100.0% 🚀
assets/session-BOxoCI1U.js (New) 1.45kB 1.45kB 100.0% 🚀
assets/tooltip-DbbRQG9y.js (New) 1.45kB 1.45kB 100.0% 🚀
assets/tabs-QTLFNvmq.js (New) 1.39kB 1.39kB 100.0% 🚀
assets/app.repos-4pTRW9Ba.js (New) 1.07kB 1.07kB 100.0% 🚀
assets/input-C-mKvrCv.js (New) 796 bytes 796 bytes 100.0% 🚀
assets/file-cog-CWI9BJDk.js (New) 758 bytes 758 bytes 100.0% 🚀
assets/docs.ai-summaries-BvyBnmuL.js (New) 506 bytes 506 bytes 100.0% 🚀
assets/app.maintainer-DFCdlLwr.js (New) 502 bytes 502 bytes 100.0% 🚀
assets/docs.backtest-calibration-DDxCHqGH.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.branch-analysis-BS3d3fjG.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.scoreability-lhHvYiMm.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.upstream-drift-BDf1UA6s.js (New) 499 bytes 499 bytes 100.0% 🚀
assets/docs.federated-fleet-intelligence-Cyc7Zs86.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.maintainer-install-trust-DZgYbNvs.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-ai-providers-XY5nWsKQ.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-backup-scaling-B7uqU3LW.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-configuration-qlS5lwgt.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-docs-audit-CnzQwJBC.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-github-app-B3TCHTSn.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-quickstart-soHz1CVG.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rag-DByGOfeY.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rees-Ejsu7-SJ.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-rees-analyzers-CgJEr4X8.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-release-checklist-DtFK0Q3t.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-releases-CHBo0XUt.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-security-tzv_Zctx.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-troubleshooting-BzRHT-cK.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.self-hosting-unified-ams-orb-B4g8KkQg.js (New) 498 bytes 498 bytes 100.0% 🚀
assets/docs.ams-config-precedence-hs6pFOpI.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-deployment-D4p0U2wF.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-discovery-plane-p3z_AKEP.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-env-reference-BpJVngTf.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-fleet-manifest-gPIG9Mom.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-goal-spec-DGC1MVnk.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-kill-switch-incident-CFnNjp-F.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-observability-ymaXbKpF.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-operations-runbook-Ce0Job1Q.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-sizing-DCCuYY1Q.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.ams-unattended-scheduling-Bo-ZryPO.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.beta-onboarding-Nv-GmjI3.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.capacity-DbMMgCRP.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.maintainer-self-hosting-BNgCvKhX.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.mcp-clients-Bj0lcLqO.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.owner-checklist-Df8vh9_C.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.quickstart-B7kkdLjO.js (New) 497 bytes 497 bytes 100.0% 🚀
assets/docs.github-app-BLQy7sFO.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.maintainer-workflow-Bve2KCZO.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.privacy-security-CQzDddMa.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.troubleshooting-D15XSoaB.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.tuning-B98gxGvF.js (New) 495 bytes 495 bytes 100.0% 🚀
assets/docs.loopover-commands-BXckCdA8.js (New) 494 bytes 494 bytes 100.0% 🚀
assets/sparkles-BIlKxwUG.js (New) 494 bytes 494 bytes 100.0% 🚀
assets/docs.how-reviews-work-DFQB2YXQ.js (New) 493 bytes 493 bytes 100.0% 🚀
assets/app.owner-D3oFnLvy.js (New) 474 bytes 474 bytes 100.0% 🚀
assets/app.commands-Hh2srV-4.js (New) 455 bytes 455 bytes 100.0% 🚀
assets/app.playground-C4Nggj9u.js (New) 442 bytes 442 bytes 100.0% 🚀
assets/reveal-BYiHgtLs.js (New) 442 bytes 442 bytes 100.0% 🚀
assets/index-DgUza6um.js (New) 438 bytes 438 bytes 100.0% 🚀
assets/app.digest-BrPJPGp-.js (New) 430 bytes 430 bytes 100.0% 🚀
assets/eye-off-Byo978xs.js (New) 430 bytes 430 bytes 100.0% 🚀
assets/app.miner-CthZbyUI.js (New) 422 bytes 422 bytes 100.0% 🚀
assets/key-round-CpWN8paL.js (New) 355 bytes 355 bytes 100.0% 🚀
assets/bot-BdzZnUoT.js (New) 328 bytes 328 bytes 100.0% 🚀
assets/trash-2-Cg9XpTmj.js (New) 328 bytes 328 bytes 100.0% 🚀
assets/save-DR9mpsoE.js (New) 327 bytes 327 bytes 100.0% 🚀
assets/git-pull-request-arrow-DAifgBzp.js (New) 321 bytes 321 bytes 100.0% 🚀
assets/wrench-CsQiYPbS.js (New) 303 bytes 303 bytes 100.0% 🚀
assets/list-checks-BoQvWt8d.js (New) 279 bytes 279 bytes 100.0% 🚀
assets/shield-CcEiqKJO.js (New) 272 bytes 272 bytes 100.0% 🚀
assets/workflow-DBWgmlm1.js (New) 265 bytes 265 bytes 100.0% 🚀
assets/compass-0qh5qwWN.js (New) 251 bytes 251 bytes 100.0% 🚀
assets/history-eD-3KwAI.js (New) 237 bytes 237 bytes 100.0% 🚀
assets/activity-Cf9HYf0s.js (New) 234 bytes 234 bytes 100.0% 🚀
assets/message-square-BMkB7YHM.js (New) 233 bytes 233 bytes 100.0% 🚀
assets/lock-CsjysiEL.js (New) 206 bytes 206 bytes 100.0% 🚀
assets/rotate-cw-CA8cXTwl.js (New) 201 bytes 201 bytes 100.0% 🚀
assets/play-CbTvyxns.js (New) 190 bytes 190 bytes 100.0% 🚀
assets/circle-check-C8XzHxyg.js (New) 178 bytes 178 bytes 100.0% 🚀
assets/search-dRkmXRUb.js (New) 174 bytes 174 bytes 100.0% 🚀
assets/circle-BJMP0LKQ.js (New) 130 bytes 130 bytes 100.0% 🚀
assets/add-scalar-classes-DoMG1MWf.js (Deleted) -2.17MB 0 bytes -100.0% 🗑️
assets/tanstack-vendor-DWvrspw9.js (Deleted) -812.72kB 0 bytes -100.0% 🗑️
assets/docs.fumadocs-spike-api-reference-CSv30828.js (Deleted) -442.92kB 0 bytes -100.0% 🗑️
assets/AgentScalarChatInterface.vue-Rj4bOqW-.js (Deleted) -201.71kB 0 bytes -100.0% 🗑️
assets/modal-C_ykDaDf.js (Deleted) -184.38kB 0 bytes -100.0% 🗑️
assets/client-BK2rdKEU.js (Deleted) -146.06kB 0 bytes -100.0% 🗑️
assets/maintainer-panel-CSrbbPU2.js (Deleted) -78.96kB 0 bytes -100.0% 🗑️
assets/tuning-CCQKmR9N.js (Deleted) -65.43kB 0 bytes -100.0% 🗑️
assets/ui-vendor-DxlHZDYq.js (Deleted) -57.04kB 0 bytes -100.0% 🗑️
assets/routes-QoaWhWEq.js (Deleted) -34.83kB 0 bytes -100.0% 🗑️
assets/owner-panel-BtE_YQB5.js (Deleted) -27.36kB 0 bytes -100.0% 🗑️
assets/app-D3YZg7E3.js (Deleted) -25.7kB 0 bytes -100.0% 🗑️
assets/ams-discovery-plane-DVYyV0n9.js (Deleted) -23.83kB 0 bytes -100.0% 🗑️
assets/app.runs-Br8Vq1VK.js (Deleted) -23.56kB 0 bytes -100.0% 🗑️
assets/miner-panel-c6XL3IQ4.js (Deleted) -20.25kB 0 bytes -100.0% 🗑️
assets/api._op-DpSv1Rxk.js (Deleted) -17.55kB 0 bytes -100.0% 🗑️
assets/self-hosting-docs-audit-DFlk9ZWN.js (Deleted) -16.63kB 0 bytes -100.0% 🗑️
assets/app.index-vQK-HEeU.js (Deleted) -15.62kB 0 bytes -100.0% 🗑️
assets/backtest-calibration-DyNIBk9H.js (Deleted) -14.52kB 0 bytes -100.0% 🗑️
assets/playground-panel-BvQMhnt4.js (Deleted) -14.49kB 0 bytes -100.0% 🗑️
assets/app.audit-BXobjF2W.js (Deleted) -10.11kB 0 bytes -100.0% 🗑️
assets/app.config-generator-CCp5Qkst.js (Deleted) -10.09kB 0 bytes -100.0% 🗑️
assets/extension-MKAII5CV.js (Deleted) -10.04kB 0 bytes -100.0% 🗑️
assets/fairness-DCrABRKT.js (Deleted) -8.34kB 0 bytes -100.0% 🗑️
assets/maintainers-B7GmmqDS.js (Deleted) -8.03kB 0 bytes -100.0% 🗑️
assets/miners-a0hcwxbL.js (Deleted) -7.85kB 0 bytes -100.0% 🗑️
assets/agents-DijuljGB.js (Deleted) -7.76kB 0 bytes -100.0% 🗑️
assets/commands-panel-B1ToX1uW.js (Deleted) -6.65kB 0 bytes -100.0% 🗑️
assets/maintainer-workflow-CxEfIpZe.js (Deleted) -6.5kB 0 bytes -100.0% 🗑️
assets/roadmap-rmj0kdTU.js (Deleted) -6.33kB 0 bytes -100.0% 🗑️
assets/digest-panel-KNxp_Ukv.js (Deleted) -6.18kB 0 bytes -100.0% 🗑️
assets/repos._owner._repo.quality-uC94JB5W.js (Deleted) -6.14kB 0 bytes -100.0% 🗑️
assets/docs.index-tU3Ub-Pt.js (Deleted) -5.61kB 0 bytes -100.0% 🗑️
assets/api.index-DCJTfp8K.js (Deleted) -4.7kB 0 bytes -100.0% 🗑️
assets/api-BHxelMfq.js (Deleted) -2.69kB 0 bytes -100.0% 🗑️
assets/docs-21XmXJCV.js (Deleted) -2.67kB 0 bytes -100.0% 🗑️
assets/app.workbench-CNn7UUeU.js (Deleted) -1.58kB 0 bytes -100.0% 🗑️
assets/session-CSiLowQ4.js (Deleted) -1.45kB 0 bytes -100.0% 🗑️
assets/tooltip-D5bjJgZ2.js (Deleted) -1.45kB 0 bytes -100.0% 🗑️
assets/tabs-BnGIuxAi.js (Deleted) -1.39kB 0 bytes -100.0% 🗑️
assets/app.repos-6TGsXLSO.js (Deleted) -1.07kB 0 bytes -100.0% 🗑️
assets/input-o7J2b3vV.js (Deleted) -796 bytes 0 bytes -100.0% 🗑️
assets/file-cog-D0XPr4N3.js (Deleted) -758 bytes 0 bytes -100.0% 🗑️
assets/docs.ai-summaries-C_yv-wU-.js (Deleted) -506 bytes 0 bytes -100.0% 🗑️
assets/app.maintainer-C_sbkeFj.js (Deleted) -502 bytes 0 bytes -100.0% 🗑️
assets/docs.backtest-calibration-BwfBbQIl.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.branch-analysis-B11bvZWY.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.scoreability-CnAw05o4.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.upstream-drift-CuL8Wwep.js (Deleted) -499 bytes 0 bytes -100.0% 🗑️
assets/docs.federated-fleet-intelligence-94bZgX7f.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-install-trust-DejINKTb.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-ai-providers-r3yaZhkQ.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-backup-scaling-BjBhv-32.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-configuration-DktHxwW5.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-docs-audit-VyB9dcl3.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-github-app-H0ryS-Xr.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-quickstart-BH345jvi.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rag-vyMMKVYy.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rees-7t-pG5RM.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-rees-analyzers-D4UmIeJ8.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-release-checklist-BQJPjWZi.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-releases-DSjujzrv.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-security-BfghHqSy.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-troubleshooting-BwOZjM5O.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.self-hosting-unified-ams-orb-BEDfKLzG.js (Deleted) -498 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-config-precedence-D_-Yamz1.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-deployment-DN5uc90k.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-discovery-plane-S1OKDzM_.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-env-reference-DXmFiGFZ.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-fleet-manifest-DMlNbyFx.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-goal-spec-B-Vj2c2j.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-kill-switch-incident-l5YlkISY.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-observability-Gnp91tz-.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-operations-runbook-R6qG4-MT.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-sizing-Bb-2IkPb.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.ams-unattended-scheduling-CUTwaVNw.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.beta-onboarding-BaPX36o3.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.capacity-RawBX8ky.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-self-hosting-CA_RKD50.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.mcp-clients-CdaHvOrC.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.owner-checklist-EXV_QpZk.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.quickstart-afDS8Uye.js (Deleted) -497 bytes 0 bytes -100.0% 🗑️
assets/docs.github-app-Dtp4gN1B.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.maintainer-workflow-DaH5n89N.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.privacy-security-DxSOZ2sZ.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.troubleshooting-FQXJS9hX.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.tuning-DzMzA6c0.js (Deleted) -495 bytes 0 bytes -100.0% 🗑️
assets/docs.loopover-commands-CpbWlMUr.js (Deleted) -494 bytes 0 bytes -100.0% 🗑️
assets/sparkles-ByQE1gIm.js (Deleted) -494 bytes 0 bytes -100.0% 🗑️
assets/docs.how-reviews-work-DYptYCRv.js (Deleted) -493 bytes 0 bytes -100.0% 🗑️
assets/app.owner-ehJSzLzs.js (Deleted) -474 bytes 0 bytes -100.0% 🗑️
assets/app.commands-Cd8w5pse.js (Deleted) -455 bytes 0 bytes -100.0% 🗑️
assets/app.playground-BW0cAJNb.js (Deleted) -442 bytes 0 bytes -100.0% 🗑️
assets/reveal-DPT3z331.js (Deleted) -442 bytes 0 bytes -100.0% 🗑️
assets/index-Dq4FohIo.js (Deleted) -438 bytes 0 bytes -100.0% 🗑️
assets/app.digest-BxipMTZz.js (Deleted) -430 bytes 0 bytes -100.0% 🗑️
assets/eye-off-CXVmEQX4.js (Deleted) -430 bytes 0 bytes -100.0% 🗑️
assets/app.miner-Rg545f-a.js (Deleted) -422 bytes 0 bytes -100.0% 🗑️
assets/key-round-DyPUz58D.js (Deleted) -355 bytes 0 bytes -100.0% 🗑️
assets/bot-C10n2klW.js (Deleted) -328 bytes 0 bytes -100.0% 🗑️
assets/trash-2-DfGZsIKE.js (Deleted) -328 bytes 0 bytes -100.0% 🗑️
assets/save-N3lRqxPd.js (Deleted) -327 bytes 0 bytes -100.0% 🗑️
assets/git-pull-request-arrow-Caj62haE.js (Deleted) -321 bytes 0 bytes -100.0% 🗑️
assets/wrench-DOj0GZ0G.js (Deleted) -303 bytes 0 bytes -100.0% 🗑️
assets/list-checks-0JT2nP7U.js (Deleted) -279 bytes 0 bytes -100.0% 🗑️
assets/shield-Bki2mcUJ.js (Deleted) -272 bytes 0 bytes -100.0% 🗑️
assets/workflow-6nU41OET.js (Deleted) -265 bytes 0 bytes -100.0% 🗑️
assets/compass-0aMzXRw8.js (Deleted) -251 bytes 0 bytes -100.0% 🗑️
assets/history-B4CHExgh.js (Deleted) -237 bytes 0 bytes -100.0% 🗑️
assets/activity-CQLlBlR7.js (Deleted) -234 bytes 0 bytes -100.0% 🗑️
assets/message-square--Ol9wwM1.js (Deleted) -233 bytes 0 bytes -100.0% 🗑️
assets/lock-CVWhoEHL.js (Deleted) -206 bytes 0 bytes -100.0% 🗑️
assets/rotate-cw-X7hpSOaX.js (Deleted) -201 bytes 0 bytes -100.0% 🗑️
assets/play-lgf9Y0QX.js (Deleted) -190 bytes 0 bytes -100.0% 🗑️
assets/circle-check-Bu6zCkJ0.js (Deleted) -178 bytes 0 bytes -100.0% 🗑️
assets/search-BbqsRtM4.js (Deleted) -174 bytes 0 bytes -100.0% 🗑️
assets/circle-Dy8xb1iV.js (Deleted) -130 bytes 0 bytes -100.0% 🗑️

@JSONbored JSONbored reopened this Jul 23, 2026
JSONbored added a commit that referenced this pull request Jul 23, 2026
…8167)

A PR whose scoped-selection paths (backend/miner/mcp/discoveryIndex) only
touch files no test imports -- e.g. a pure docs-only change under
packages/loopover-miner/docs/** -- correctly triggers scoped test selection
(vitest --changed=origin/main), which then correctly finds nothing to run
("No test files found, exiting with code 0"). That legitimate outcome wrote
no coverage/lcov.info, which "Verify coverage report exists" treated as a
hard failure regardless of cause.

Confirmed live: PR #8165 (packages/loopover-miner/docs + apps/loopover-ui/
content/docs mdx only) failed all 3 validate-tests shards this way despite
nothing being broken.

Captures vitest's own "No test files found" stdout in the scoped branch and
skips the coverage-existence check specifically for that case, while a real
failure (tests ran and failed, or the step crashed before producing output)
still fails the job exactly as before.
@loopover-orb loopover-orb Bot added the gittensor:bug Gittensor-scored bug fix — scores a 0.05x multiplier. label Jul 23, 2026
@loopover-orb

loopover-orb Bot commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Caution

🛑 LoopOver review result - fixes required

Review updated: 2026-07-23 08:01:18 UTC

2 files · 1 AI reviewer · no blockers · CI failing · blocked

🛑 Suggested Action - Manual Review

Review summary
Docs-only PR that updates two mirrored operator guides (docs-site mdx + package README) to reflect the now-shipped discovery-index plane: env vars, the new LOOPOVER_MINER_DISCOVERY_SHARED_SECRET, a dry-run verification step, and a correction of the telemetry claim (HMAC-hashed identifiers were never shipped — actual code only emits a bare local {event, outcome} log line). The two files stay in sync with each other and the description's claims are internally consistent and plausible given the stated verification steps (live curl checks, cross-referencing shipped modules). Closes #7169 as required.

Nits — 6 non-blocking
  • The diff uses 'master opt-in' (apps/loopover-ui/content/docs/ams-discovery-plane.mdx and packages/loopover-miner/docs/discovery-plane-operator-guide.md) — consider 'primary opt-in' for neutral terminology.
  • The failing 'validate' / 'validate-tests (1-3)' checks have no detail provided, and this branch is 3 commits behind default — likely explained by drift rather than this docs-only diff, but worth confirming before merge since the cause can't be verified from what's given.
  • Since this PR touches no src/** files, confirm the failing validate-tests checks are indeed pre-existing/unrelated (e.g., by checking if they also fail on latest default branch) rather than assuming so.
  • Consider linking chore(discovery-plane): decide and stand up hosting/deployment for the discovery-index server #7167/feat(discovery-plane): implement hosted soft-claim coordination/dedup endpoint #7166/feat(discovery-plane): implement the hosted discovery-index query service #7164 inline in the mdx file the way the .md file does, for consistency between the two mirrored docs.
  • PR author also opened the linked issue — Link an issue that was opened by a different contributor, or provide a rationale for why this self-authored issue represents genuine discovery work.
  • Diff looks like trivial or whitespace-only churn — Reduce whitespace-only or formatting-only churn and keep the diff focused on substantive changes.

CI checks failing

  • validate
  • validate-tests (3)
  • validate-tests (1)
  • validate-tests (2)
  • validate
  • validate-tests (2)
  • validate-tests (1)
  • validate-tests (3)

Decision drivers

  • ✅ Code review — No blockers (1 reviewer)
  • ✅ Gate result — Passing (No configured blocker found.)
Context & advisory signals — never blocks the verdict
Signal Result Evidence
Linked issue ✅ Linked #7169
Related work ✅ No active overlap found No same-issue or scoped active PR overlap found.
Change scope ✅ 20/20 Low review scope from cached public metadata (1 linked issue).
Validation posture ✅ 25/25 PR body includes validation/test evidence.
Contributor workload ✅ 10/10 Author activity: 14 registered-repo PR(s), 14 merged, 253 issue(s).
Contributor context ✅ Confirmed Gittensor contributor JSONbored; Gittensor profile; 14 PR(s), 253 issue(s).
Improvement ℹ️ Insufficient signal risk: low · value: insufficient-signal · LLM: moderate
Linked issue satisfaction

Addressed
The PR rewrites the operator guide from provisional/TBD to shipped state, adds a concrete opt-in walkthrough with the hosted URL and a dry-run verification step, and re-verifies each invariant against the actual shipped client code (correcting the telemetry HMAC claim that had drifted from reality).

Review context
  • Author: JSONbored
  • Role context: owner (maintainer lane)
  • Public audience mode: oss maintainer
  • Lane context: Repository is configured for direct PR review.
  • Public profile languages: Python, TypeScript, Ruby, Go, JavaScript, MDX, Shell, Solidity
  • Official Gittensor activity: 14 PR(s), 253 issue(s).
  • PR-specific overlap: none found.
Contributor next steps
  • Start here: Treat this as maintainer-lane context rather than normal contributor-lane activity.
Signal definitions
  • Related work = same linked issue, overlapping active PRs, or title/path similarity.
  • Change scope = cached public metadata such as size labels, draft state, and review-burden hints.
  • Validation posture = whether the PR provides enough public validation/test evidence for maintainer review.
  • Contributor workload = public contributor activity and cleanup pressure, not a repo-wide quality failure.
  • Contributor context = public GitHub/Gittensor identity context; non-Gittensor status is not a blocker.
🧪 Chat with LoopOver

Ask LoopOver a question about this PR directly in a comment — grounded only in the same cached, public-safe facts shown above, never a new claim.

  • @loopover ask <question> answers contribution-quality Q&A with source citations and freshness.
  • @loopover chat <question> answers in natural prose from cached decision-pack facts via local inference (maintainer/collaborator; read-only).
  • A plain-language @loopover mention with a real question is routed to the closest matching read-only command automatically — no exact syntax required.

Full command reference: https://loopover.ai/docs/loopover-commands

🧪 Experimental — new and may change.

Visual preview
Route Viewport Before (production) After (this PR's preview) Diff
/ desktop before /
before /
after /
after /
/ mobile before / (mobile)
before / (mobile)
after / (mobile)
after / (mobile)

Click any thumbnail to open the full-size screenshot. Before = production · After = this PR's preview deploy.

Scroll preview
Route Before (production) After (this PR's preview)
/ before / (scroll)
before / (scroll)
after / (scroll)
after / (scroll)

A short scroll-through clip (desktop) — click either thumbnail to open the full animation. Evidence for scroll-linked behavior a single screenshot can't show.

🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed


💰 Earn for open-source contributions like this. Gittensor lets GitHub contributors earn for the work they already do — register to start earning →.

Checked by LoopOver, a quiet PR intelligence layer for OSS maintainers.

  • Re-run LoopOver review

@loopover-orb loopover-orb Bot added the manual-review Gittensor contributor context label Jul 23, 2026
@JSONbored

Copy link
Copy Markdown
Owner Author

Closing and reopening as a fresh PR to force a clean CI run against the current branch tip (post-rebase onto the CI fix in #8167) -- the previous run was stuck showing stale results against the pre-rebase commit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gittensor:bug Gittensor-scored bug fix — scores a 0.05x multiplier. manual-review Gittensor contributor context

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs(discovery-plane): finalize operator guide once env vars ship

1 participant